home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / games / addons / twilit.arj / TWILIGHT.TXT < prev    next >
Text File  |  1994-03-15  |  19KB  |  451 lines
  1. Twilight Dream
  2. Version 1.00
  3. March 15,1994
  4.  
  5. by Jim Signorile
  6. Copyright 1994 James V. Signorile
  7.  
  8. TWILIGHT DREAM is a 3rd party After Dark (for Windows) screen saver module.
  9.            It is released as Shareware.
  10. TWILIT.ZIP    is the BBS filename for the compressed file this came from.
  11. TWILIGHT.AD   is the After Dark module.
  12. TWILIGHT.MID  is an accompanying MIDI music file.
  13. TWILIGHT.WRI  is this file you are reading.
  14.  
  15. Features
  16.     -  256 color graphics.
  17.     -  Original MIDI music soundtrack.
  18.     -  Special graphics effects.
  19.     -  Custom modules offer.
  20.  
  21. Installation
  22.  
  23. This module requires Berkeley Systems After Dark (for Windows), Version 2.0 
  24. or later, screen saver program to run.  Once After Dark has been installed 
  25. on your system, copy the files TWILIGHT.AD and TWILIGHT.MID to your Afterdrk 
  26. directory (or whatever directory you have After Dark installed in). If you 
  27. have the Disney Collection, you can put TWILIGHT.MID into the MUSIC sub-
  28. directory. MUSIC is a subdirectory of AFTERDRK and was created during the 
  29. Disney Collection installation.  (Or you can create a MUSIC subdirectory on 
  30. your own and put TWILIGHT.MID into there...but later installing Disney might 
  31. cause that directory to be overwritten... just be aware!).
  32.  
  33. When adding new modules to After Dark, you must rebuild the control panel 
  34. for them to show up in the list of screen savers.  Rebuild the control panel 
  35. by holding down the <Ctrl> key while double-clicking on the After Dark icon, 
  36. in either the Program Manager or on the desktop.  You can also call up the 
  37. control panel and rebuild the control panel from the file manager by holding 
  38. down the <CTRL> key and double clicking on the AD.EXE file (in your AFTERDRK 
  39. directory).  After Dark will display the message "Updating After Dark module 
  40. settings.." as it rebuilds the control panel.
  41.  
  42. Note: Rebuilding the control panel will reset all modules to their original 
  43. settings. To keep your module settings, make backup copies of the files 
  44. ADMODULE.ADS and AD_PREFS.INI, both located in your Windows directory.  
  45. After rebuilding the control panel, copy these backups back into your Windows 
  46. directory, replacing the newly created ones.
  47.  
  48. To see Twilight Dream, open your After Dark Control Panel by double-clicking 
  49. on the After Dark icon from the Program Manager or other desktop shell (or 
  50. running AD.EXE from the file manager in your AFTERDRK directory).  All 
  51. installed modules will be listed alphabetically.  Select Twilight Dream by 
  52. clicking on the name "Twilight Dream" in the scrollable Module List.  This 
  53. will select twilight.ad as the module to run when After Dark activates.  For 
  54. more information about Twilight Dream, click on the Info triangle at the 
  55. bottom right corner of the Control panel, or press <Alt>-H.  Click anywhere 
  56. in the Info box to return to the Control Panel.
  57.  
  58. You can preview Twilight Dream by clicking the Demo button.  In this mode you 
  59. can experiment with the controls for different effects.  Try Effects on 
  60. Bounce to see special image effects.  Click Stop to end the demo.  For on-
  61. line help about how to use After Dark in general, click the "?" button in the 
  62. lower right corner, or press the <F1> key.
  63.  
  64. Twilight Dream uses MIDI sound, therefore a Speaker volume control will 
  65. appear if your system supports Multimedia sound.  The volume can range from 
  66. loud to very soft.  Activate After Dark (and therefore Twilight Dream, if 
  67. it's currently selected) as described in the After Dark on-line help or 
  68. manual.
  69.  
  70.  
  71. MIDI Music
  72.  
  73. Twilight Dream includes a full MIDI music soundtrack of my original 
  74. composition "Twilight Dream" (hey, good name for a module...).  Twilight 
  75. Dream's music is written in General MIDI format.
  76.  
  77. TO HEAR THIS MIDI MUSIC, YOU MUST BE RUNNING WINDOWS 3.1 OR LATER, AND HAVE A 
  78. SOUND CARD CAPABLE OF PLAYING MIDI FILES INSTALLED IN YOUR  PC (OR AN 
  79. EXTERNAL MIDI SYNTHESIZER CONNECTED TO YOUR PC).
  80.  
  81. The Sound Blaster Pro, or above, will work just fine.
  82.  
  83. YOU MUST ALSO HAVE YOUR MIDI MAPPER SET UP CORRECTLY FOR YOUR SOUND CARD OR 
  84. EXTERNAL MIDI SYNTHESIZER INTERFACE CARD.
  85.  
  86. More details on these topics a bit later.
  87.  
  88.  
  89. There is a slider in the Twilight Dream After Dark Control Panel that 
  90. controls how many times the music plays -- Never, Once, Twice, Thrice or 
  91. Always (continuously).  The speaker icon arrows raise or lower the volume of 
  92. the music. (This is true if your MIDI sound card/interface supports volume 
  93. control...not all of them do...for example, if the MIDI mapper ports are set 
  94. to SB Pro Stereo FM, volume control will work, but if the ports are set to 
  95. SB MIDI Out, sending the MIDI to an external MIDI device, the volume will not 
  96. change...you have to adjust the volume on the external device yourself.  In 
  97. general, internal sound cards will respond to After Dark volume controls, 
  98. while external MIDI devices will not).
  99.  
  100. If for any reason Twilight Dream can't play the MIDI music (no MIDI device 
  101. available, MIDI mapper incorrect, MIDI file (twilight.mid) missing,  
  102. insufficient memory, etc.), the module will still animate, but the music will 
  103. not play.  You probably want to hear the music (I hope!) so on to trouble-
  104. shooting some common problems with playing MIDI files.
  105.  
  106.  
  107. Troubleshooting  MIDI Problems
  108.  
  109. - If you don't hear music :  First, make sure the file twilight.mid is in the 
  110. After Dark directory, or in the music subdirectory under it.  Then make sure 
  111. the music volume is turned up (the speaker icon should have "lines" in front 
  112. of it), the music slider isn't set to Never, and the Mute Sound check box (in 
  113. the After Dark Control panel Setup... Sound... dialog box) isn't checked. 
  114. Also in the Setup... Sound... dialog box be sure you have selected for Output 
  115. Device:  Multimedia Windows Sound (Windows 3.1).  If these controls are set 
  116. correctly, and you still don't hear music, read on.
  117.  
  118. - Test Your Sound Hardware :  From the Program Manager Main group, double-
  119. click on Control Panel, then double-click on Sound.  Highlight any .WAV file 
  120. you have on your disk, and click the Test button.  If you don't hear sound 
  121. from your external speakers, check your speakers, cables, and sound card to 
  122. make sure all the hardware is installed and connected properly.  If your 
  123. sound card has a volume wheel on it (as on the back of the Sound Blaster), be 
  124. sure it is turned up.  See the hardware manufacturer's instructions for more 
  125. information.
  126.  
  127. - Test your MIDI Configuration :  After making sure your sound hardware is 
  128. set up correctly, open the Program Manager Accessories group (or the group 
  129. where you have Media Player) and double-click on Media Player.  From the 
  130. Windows directory, open the file Canyon.mid (a MIDI file that comes with 
  131. Windows), and click on the Play button (the button with the triangle pointing 
  132. to the right).  If you don't hear music, go to the Program Manager Main 
  133. group, double-click on Control Panel, and double-click on MIDI Mapper.  
  134. Choose a different setting from the Name: pull-down menu, and close the MIDI 
  135. Mapper.  Go back to the Media Player, and try playing Canyon.mid again.  
  136. Keep trying different settings within the MIDI Mapper (closing it each time) 
  137. until you find a setting that will play Canyon.mid correctly (it should play, 
  138. and play correctly...that is, it should sound nice).
  139.  
  140. If you try all of the settings and you still can't play Canyon.mid, reinstall 
  141. the sound software that came with your sound card.
  142.  
  143.  
  144. *****************************************************************************
  145. RECOMMENDATION 
  146.  
  147. If you're using a Sound Blaster Pro or Sound Blaster Pro Basic, you might 
  148. want to log onto the Creative Labs Compuserve forum (GO BLASTER), and 
  149. download the latest Windows 3.1 drivers for the Sound Blaster Pro.  Select 
  150. library section 3 (Updates and Fixes), and download the file "SBPWU.EXE" 
  151. (it's a self-extracting archive).  Create a new subdirectory on your hard 
  152. disk, copy sbpwu.exe into it, and run sbpwu.exe to cause the archived files 
  153. to be created into your subdirectory.  Just follow the instructions in the 
  154. included README.TXT file, and your MIDI system (including the MIDI mapper) 
  155. should be set up fine to play Twilight Dream.
  156.  
  157. There are also files in this same library for other Sound Blaster Cards 
  158. (SB Pro 2,  SB 16, SB 16 ASP, Wave Blaster. etc.), so you will want to 
  159. download the drivers appropriate for the sound card you have.  Leave a 
  160. message on the Creative Labs forum if you're not sure which file(s) to 
  161. download.  If you have other brands of sound cards, see if those companies 
  162. have Compuserve forums, or other BBS access where you can obtain the latest 
  163. sound driver software.
  164. *****************************************************************************
  165.  
  166.  
  167. -  Once Your Hardware and MIDI are Working :  Once Canyon.mid plays correctly 
  168. through your external speakers, close the Media Player (make sure the MIDI 
  169. Mapper is also closed), and open the After Dark Control Panel.  Select 
  170. Twilight Dream, make sure that the music volume is turned up, the music 
  171. slider isn't set to Never, the Mute Sound check box isn't checked, and 
  172. Multimedia Windows Sound is selected, then use the Hot Key or Sleep Corner to 
  173. put your screen to sleep (and to let it begin "Twilight Dream"ing).
  174.  
  175.  
  176. If you still don't hear music, reinstall your latest version of After Dark.
  177.  
  178.  
  179. If All Else Fails
  180.  
  181. If you have performed the tests and procedures described above, and 
  182. everything is working correctly, but you still don't hear music from Twilight 
  183. Dream, please contact me at my Compuserve or Internet address listed at the 
  184. end of this file.  I will try to help you solve your problem.
  185.  
  186.  
  187.  
  188. The Shareware Story
  189.  
  190. The Twilight Dream After Dark Screen Saver module is a shareware program by 
  191. Jim Signorile. Many thanks to the wonderful Beta Testers all over the U.S. 
  192. who tested this program & provided constructive criticism and helpful 
  193. suggestions.
  194.  
  195.  
  196. As shareware, you are entitled to try an evaluation version of Twilight Dream 
  197. out for 15 days free, upload it to online services, and give copies to 
  198. associates, subject to the following conditions:
  199.  
  200.  
  201. 1) Much time and effort went into writing and testing Twilight Dream.  If you 
  202. don't use Twilight Dream, you promise to throw it out.  If you do use it, you 
  203. promise to pay me the modest $10 (U.S.) shareware fee.
  204.  
  205. By paying the shareware fee, you will become a registered user of Twilight 
  206. Dream.  You can send whatever you think Twilight Dream is worth, but if you 
  207. send at least $10 U.S.,  you will be eligible for the option of having custom
  208. modules created for you as described below.
  209.  
  210. Paying the small shareware fee for something you find useful encourages the 
  211. free exchange of information currently enjoyed by the software community.  
  212. It also encourages me to support and upgrade the program.  Not paying is both 
  213. unlawful and hurts everyone involved in the shareware effort (and it's really 
  214. not very nice).
  215.  
  216.  
  217. 2) You may give an evaluation copy (non-personalized) of Twilight Dream to 
  218. others, but you may not distribute Twilight Dream for direct or indirect 
  219. profit by any means, except through expressed written agreement with 
  220. James V. Signorile.
  221.  
  222.  
  223. 3) You may not alter TWILIGHT.AD, TWILIGHT.MID, or TWILIGHT.WRI (this 
  224. documentation) in any way.  When distributing Twilight Dream, you must 
  225. include this documentation with the package.
  226.  
  227.  
  228. 4) While every effort has been made to test Twilight Dream in various 
  229. environments, I am not liable for any damages caused directly or indirectly 
  230. through the use or misuse of Twilight Dream.  Twilight Dream is provided 
  231. *as is*, and I provide no guarantee that any specific features will be added 
  232. in the future, nor any guarantee of its fitness for any specific purpose.  
  233. I do not guarantee compatibility with future versions of system software, 
  234. Windows, After Dark, or any other products, although future versions of 
  235. Twilight Dream will be upgraded to stay current with changes in Windows and 
  236. After Dark for Windows, if I continue to receive user support through 
  237. shareware fees and registration.
  238.  
  239.  
  240.  
  241. The Shareware Fee
  242.  
  243. If you send me $10 U.S. or more, you will become a registered (and 
  244. authorized) user of Twilight Dream, and as such, you are eligible for the 
  245. Custom Module offer described below.
  246.  
  247. I also offer group licenses for sites or LANs that have many Twilight Dream 
  248. users.  The sliding fee scale makes Twilight Dream less expensive per user as 
  249. the size of your group increases.
  250.  
  251. Twilight Dream Group License Fee Scale
  252. (See Register On-Line for On-Line Registration.)
  253.  
  254. # of Users      Cost per User (U.S.)
  255. 1-19                    $10.00
  256. 20-49                   $ 7.50
  257. 50-99                   $ 6.00
  258. 100 or more             $ 5.00
  259.  
  260. The costs listed in my fee scale include one master disk.  Add $2.50 for each 
  261. additional master disk you require.   If you do not specify your disk 
  262. preference, I will use 3.5 inch 1.44 MB (High Density) disks.
  263.  
  264. Upgrades will be posted on Compuserve and other online services and BBS's.  
  265. Registered users can use these services to get new versions.  If you do not 
  266. have access to online services, you can request that I mail out the new 
  267. version (send $5 for the disk & shipping and handling).
  268.  
  269. Twilight Dream, and upgrades, will also be available on "The Country Post" a 
  270. BBS with sections dedicated to 3rd party After Dark Modules.  The number is 
  271. 603-424-8367, and it's N,8,1 at 14,400.  It's a great place to look for all 
  272. your non-commercial After Dark needs!
  273.  
  274.  
  275. How to Pay
  276.  
  277. I can accept payment in the following ways:
  278.  
  279. a)  Checks in U.S. dollars drawn on a U.S. bank.
  280. b)  Money orders in U.S. funds (from any country)
  281. c)  U.S. Cash currency (from any country)
  282. d)  Register On-Line - Log onto The Country Post and register on-line.  Go to
  283.     the Country Store and charge your registration to Visa or Master Card.
  284.  
  285.  Registering on line gets you a number of benefits :
  286.  
  287.   1) A registered version of  Twilight Dream (from Jim Signorile).
  288.   2) A FREE collection of over 35 Third Party After Dark Modules (by various
  289.      authors).
  290.   3) One Year of complete access to the BBS with one hour of connect time per
  291.      day.
  292.   4) The chance to BETA test new modules (must have programmers permission).
  293.   5) News of upcoming modules and events concerning After Dark.   And more...
  294.  
  295.   Cost to register on line is $20.  Even if you do not register on-line you
  296.   are welcome to use the BBS as a non-registered user.
  297.  
  298. To register by mail please fill out the registration form (at the end if this
  299. file) and include it with your payment.  To register by mail as an authorized
  300. user of Twilight Dream, send your shareware fee of $10 U.S.  payable to:
  301.  
  302. James V. Signorile
  303. 12 E Maple St
  304. Teaneck, NJ, 07666-3802
  305.  
  306.  
  307.  
  308. Other Opportunities and Offers
  309.  
  310. Here's the really good part!  If you send in the shareware fee, and are a 
  311. registered user of Twilight Dream, you become eligible to have custom modules 
  312. built just for you!  For an additional fee of $20 U.S. (plus $5 for a Disk & 
  313. Shipping and Handling), you can send me a photograph or bitmap you like, and 
  314. I will rebuild Twilight Dream to include your picture instead of mine in the 
  315. module.  (Please no "obscene" or otherwise objectionable pictures...they will
  316. just be returned to you and your money refunded).
  317.  
  318. If you have a favorite picture of your spouse, or kids, or dog/cat, or 
  319. landscape, or sunset, or whatever,  you can send me either a photograph (I'll 
  320. do my best to return it unharmed, but I can't guarantee that..sender beware!) 
  321. or a bitmap of up to 256 colors, and I will mail back to you your own module, 
  322. customized just for you (you can even pick your own name and Control Panel 
  323. info for it).
  324.  
  325. I might consider writing custom music to replace "Twilight Dream" to go with 
  326. your module, but that is a large task, and we would have to talk to decide on 
  327. a price for it.   Also, more than one picture could be included in the module 
  328. (picture switching when it bounces off the side), but that would also require 
  329. us to discuss pricing, based on the number of pictures you would want used.
  330.  
  331. Company's and businesses :  If you would like to have your company logo or 
  332. trademark floating around your offices, or those of your customers and 
  333. clients, I'd be happy to site license larger numbers of custom modules for 
  334. you, and if they all use the same picture, I will apply the sliding scale 
  335. below:
  336.  
  337. Site License Custom Module Fee Scale
  338. (all using the same picture)
  339.  
  340. # of Modules    Cost per Module (U.S.)
  341. 1-4                     $20.00
  342. 5-19                    $15.00
  343. 20-49                   $10.00
  344. 50 or more              $ 5.00
  345.  
  346.  
  347. Add to the costs listed in my fee scale $5.00 for one master disk & Shipping 
  348. and Handling.  Add $2.50 for each additional master disk you require.  If you 
  349. do not specify your disk preference, I will use 3.5 inch 1.44 MB (High 
  350. Density) disks.
  351.  
  352. This is a unique and exciting shareware offer, and I hope many of you will 
  353. take advantage of it.  Try it, you'll like it!
  354.  
  355.  
  356. Feedback
  357.  
  358. I appreciate and encourage all user feedback that will help me improve this 
  359. product. For any questions or comments, you can contact me by mail, or online 
  360. services as detailed below:
  361.  
  362. Jim Signorile
  363. 12 E Maple St
  364. Teaneck, NJ, 07666-3802
  365.  
  366. Compuserve:   70743,454
  367. Internet      signoril@sun490.fdu.edu
  368.  
  369. Thanks!!!
  370.  
  371. This documentation would not be complete without my again thanking those Beta 
  372. Testers who gave of their time to make this product as good as possible.   
  373. My gratitude to:
  374.  
  375.     Andy McBride
  376.     Bill Bowlus
  377.     Scott Garcia
  378.     Bob Loeffler
  379.     Gerry "Dad" Rossi
  380.     Gene "Bob" Spiller
  381.     Andrew "Bob" and Marylou "Bob" Ferguson
  382.     Dave "Bob" Rupert
  383.  
  384. Special thanks to Larry Widing for his Bitmap expertise and assistance.
  385.  
  386. And very special thanks to Bill Stewart without whose help I could never have 
  387. completed this module in the first place!
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395. -----------------------------------------------------------------------------
  396. Registration Form
  397.  
  398. To register as an authorized user of Twilight Dream, please send your
  399. shareware fee of $10 U.S. payable to: 
  400.  
  401. James V. Signorile
  402. 12 E Maple St
  403. Teaneck, NJ, 07666-3802
  404.  
  405.  
  406. Please include the following information with your shareware fee to help me 
  407. make Twilight Dream even better.  It will also make it easier for me to 
  408. inform you of upgrades, etc.
  409.  
  410. Twilight Dream: 1.00
  411.  
  412. Name:
  413.  
  414. Company:
  415.  
  416. Address:
  417.  
  418.  
  419.  
  420. Compuserve ID:
  421.  
  422. Internet Address:
  423.  
  424.  
  425. Phone No: (voice)
  426.  
  427. Phone No: (fax)
  428.  
  429.  
  430. Where you obtained Twilight Dream:
  431.  
  432.  
  433.  
  434.  
  435. Questions/Feedback:
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446. Thanks for your support and Enjoy!!!
  447.  
  448. -- Jim Signorile
  449. ----------------------------------------------------------------------------
  450.  
  451.